home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Gold Medal Software 3
/
Gold Medal Software - Volume 3 (Gold Medal) (1994).iso
/
wordproc
/
hshell1.arj
/
HS.HYP
< prev
next >
Wrap
Text File
|
1993-12-29
|
63KB
|
1,640 lines
.INDEX
.HEADER
~Tg$1~TG - $2 $N ~C55~TC$4 $5~TW
~a~i6
.FOOTER
~L21~i0
~APress space bar to continue~PF+~K ~E
~j<~L23~i0~X79~b1~Z~h<~L23~i0~X79~b1~X79~Y3~F~Py-~E~X79~Y4~F ~Py-~E~X79~Y21~F ~Py+~E~X79~Y22~F~Py+~E~Z~L23~X2~F-~PF-~K-~E~X$f║~X76~F+~PF+~K+~E
F1 ~AHELP~PkF1~E F2 ~ACONTENTS~PkF2~E F3 ~ABACKSTEP~PkF3~E F4 ~AHISTORY~PkF4~E F5 ~ANOTES~PkF5~E F6 ~ASEARCH~PkF6~E F7 ~ATYPE~PkF7~E F10 ~AQUIT~PkF0~E
.REMARK
HyperShell hyperfile - Copyright (c) N.G.Taylor 1989,1990,1991
Scrollbar frame design - Copyright (c) Werner Knudsen, 1991
.
.REMARK
.
.NOTE Scrolling
To scroll between frames or within a frame using keyboard or mouse.
Next frame: Press '+', or click on ~F+~P~E symbol on lower edge.
Previous frame: Press '-', or click on ~F-~P~E symbol on lower edge.
Position at frame: Move mouse cursor to lower edge and click at the
required position on the bar. The upright shows the current frame.
current frame position position cursor and click
════════════════════════║══════════█═══════════════════════════════
Next page: Press 'PgDn', or click on the ~F~P~E symbol on the frame's
~F ~P~E rightmost edge.
Previous page: Press 'PgUp', or click on the ~F ~P~E symbol on the frame's
~F~P~E rightmost edge.
The 'page scroll' symbols only appear when a frame contains more
than 1 page.
.
.REMARK
Global menus, notes and scripts
.
.MENU Help
Selecting |NSelecting
Scrolling |NScrolling
Contents |NContents
Backtrack |NBacktrack
Select back |NSelect back
Noted Frames |NNoted Frames
Search text |NSearch text
Type File |NType File
Do action |NDo action
DOS Gateway |NDos Gateway
Quit |NQuit
Funct. keys |NFkeys
Other Keys |NOther Keys
Information |NInfo
Colour key |NKey
Noting frames |NINS
Popup menus |Npopup menu
Paged lists |NPaged list
.
.NOTE Selecting
Use the cursor keys or the mouse to
move the mouse cursor ('block') to the
reference, or use TAB (or SHIFT TAB)
to move to the next (or previous)
reference. Press the LEFT mouse
button or RETURN (ENTER) to select the
reference.
Press RIGHT mouse button or ESCAPE to
select control ~Npopup menu~E.
.
.NOTE Help
- F1 -
This gives help about using the
HyperShell program.
.
.NOTE Contents
- F2 -
This provides a ~Npaged list~E
showing the full list of frames
in the hyperfile, and allows
selection of one of them from
the list.
.
.NOTE Backtrack
- F3 -
This returns to the previous frame
displayed, stepping back one frame
at a time.
.
.NOTE Select back
- F4 -
This displays a ~Npaged list~E of
frames visited so far, and allows
you to unwind the backtrack list
to the selected frame.
.
.NOTE Noted frames
- F5 -
This key allows you to select a
reference previously noted using
the ~NINS~E key, from a ~Npaged list~E
of noted references.
.
.NOTE Search Text
- F6 -
This selection allows a search to be made for a text
string in the frame texts, producing a ~Npaged list~E
showing the line of text containing the string and
the frame within which it was found. You can select
one of the located frames, and you can note the
frames for later viewing using the ~NINS~E key when
the cursor is over their reference. Press any key
during the search to abort at the current point.
.
.NOTE Type file
- F7 -
This produces a ~Npaged list~E showing
the named file, and permits searching and
bidirectional paging through the file.
.
.NOTE Do Action
- F8 -
This allows you to enter a HyperShell
action for immediate execution.
Try the action p=2+3*4
.
.NOTE DOS Gateway
- F9 -
If you want to temporarily suspend
viewing the hyperfile, press the F9
key. When you wish to return, type
'EXIT' at the DOS prompt.
.
.NOTE Quit
- F10 -
This exits HyperShell
and returns to DOS.
.
.NOTE INS
Pressing the INS key when viewing a
frame or when positioned over a
reference will add a reference to
the noted frames list, for later
selection from the ~NNoted frames~E menu.
The ~NDEL~E key can be used to remove
noted references from the list.
.
.NOTE DEL
The DEL key can be used
to remove noted frames
from the notepad list.
Simply position the
cursor for selection
and press the DEL key.
.
.NOTE popup menu
You can select from a popup menu
by using the cursor keys or mouse
to highlight the option to be
selected, then press LEFT mouse
button or RETURN (ENTER) key. Or
select using function keys for F1
to F0 or shifted function keys
for S1 to S0. Press the RIGHT
mouse button or the ESCAPE key or
select outside the menu to cancel.
.
.NOTE Paged list
Paged lists, such as the contents
list, allow you to page through
the list using the PgDn, PgUp and
Home keys. You can select a
frame reference just as you do in
the frame display. Some function
keys may also be used in a paged
list display, and depend on the
list being viewed.
.
.NOTE Key
A ~Mmenu~PNKey~E gives a menu.
A ~Nnote~PNKey~E displays a note.
A ~Freference~PNKey~E allows a
new frame to be selected.
An ~Aaction~PNKey~E does some
other action.
An ~Iinput field~Pp%s;NKey~E permits some
value to be entered.
.
.NOTE Fkeys
F1 Help F2 Contents
F3 Backtrack F4 Select backtrack
F5 Notepad F6 Search text
F7 Type file F8 Do action
F9 DOS Shell F10 Quit
.
.NOTE Info
- $9 -
Frame: $1
Title: $2
File : $3
Date : $4
Time : $5
~ABacktrack ~O2 ~PO2A;NInfo~E with $6 entries
Error status $? ~C32~AClear~PYah;NInfo~E
.
.SCRIPT envvar
Nenvironment variable
DSET
.
.NOTE environment variable
For details on what environment
variables are, see your MSDOS
manual. Type SET at the DOS
prompt to see the currently
set environment variables.
.
.SCRIPT Onexit
NThanks
Q
.
.NOTE Thanks
Thank you for trying HyperShell.
Why not try the other demonstrations and
then try developing a simple file yourself.
The documentation tells you how to do this.
If you find HyperShell of use for developing
your own applications, you must pay a
registration fee to Text Technology for a
licence.
See the README file for further details.
.
.SCRIPT position
-- get mouse position
ZG
-- is it on scroll bar
Vg&Y;vg23;anq
Vf&X;vf11;alq
-- if in range, go to frame
Vf=f-10;F&a$f
.
.SCRIPT FTS
-- for frame position indicator
Vf&j$1;Vf=f+10
vf76;alq
Vf76
.
.SCRIPT SETUP
O#
KF1MHelp
KM1HELP
KF0SOnexit
O30
KG1Sposition
KG0SFTS
.
.CHECK of
.
.FRAME Welcome
.TITLE to HyperShell
~i0~Tg
╓ ╖ ╔═════╗
║ ║ ║ ╖ ╖ ╖
║ ║ ║ ║ ║ ║
╠══════╣ ╚═════╗ ║ ║ ║
║ ║ ╓ ╖ ╔════╗ ╔════╗ ╔═════ ║ ╠════╗ ╔════╗ ║ ║
║ ║ ║ ║ ║ ║ ╠════╝ ║ ║ ║ ║ ╠════╝ ║ ║
╙ ╜ ╚════╣ ╠════╝ ╚════╝ ╙ ╚═════╝ ╙ ╜ ╚════╝ ╙ ╙ tm
────────────── ║ ║ ──────────────────────────────────────────────────────
╚════╝ ╙
~A~Psscroll~E~Q
HyperShell is Copyright (c) Text Technology 1988-1993. All Rights Reserved
.
.SCRIPT scroll
O*31
i~X2~Y14~a~X78~Y19~TR~BG~b3~Ty
LStart
i ~Y1 -- H Y P E R S H E L L --~C76
i ~w1 HyperShell is a versatile, configurable, hypertext system
Vx&G100;jrnext
i Which may be used for a number of purposes ~d. . . . . . .
Vx&G100;jrnext
i Help systems, Reference guides, Menu systems, DOS managers
Vx&G100;jrnext
i ~C76 Information systems, Simple flatfile databases, Text databases
Vx&G100;jrnext
i ~C76 Computer aided instruction, tests, exams with multi choice and timing
Vx&G100;jrnext
i ~C76 Interactive literature, adventure games, prototyping
Vx&G100;jrnext
i ~C76 Slide show presenters, ~DJDemonstration systems~DK, Tutorials
Vx&G100;jrnext
i ~C76 Multi-dimensional outliner for design support and documentation
Vx&G100;jrnext
i ~C76 Catalogues, pricelists, parts guides, diagnostic guides
Vx&G100;jrnext
i ~C76
Vx&G100;jrnext
i ~C76
Vx&G100;jrnext
i ~C76
Vx&G100;jrnext
JStart
Lnext
O*30
Zr
ZU ;
.
.FRAME Directions
.TITLE What do you want to know
This is not one of those demonstrations which lead you through a
complete sequence of fancy displays, without you being able to control
it or 'escape'. Hypertext is all about you, the user, being in control
of what you want to read, and the order in which you wish to read it.
You can press function key 10 at any time to stop the program. Well,
what happens now? This depends on how familiar you are with hypertext,
and what you want to find out first. Press the number key shown next
to one of the options below. Use the F3 key to backtrack to this menu.
[1] ~AWhat is hypertext?~PFHypertext~K1~E
[2] ~AWhy use hypertext?~PFAdvantages~K2~E
[3] ~AWhy choose HyperShell?~PFHyperShell~K3~E
[4] ~AWho is the system for?~PFMarket~K4~E
[5] ~AWhat can it be used for?~PFUses~K5~E
[6] ~AWhat do I get for my money?~PFComponents~K6~E
[7] ~AWhat does Version 5 provide?~PFVersion 5~K7~E
[8] ~AWhat does it all mean?~PFConcepts~K8~E
[9] ~AHow do I use the system?~PFNavigation~K9~E
.
.FRAME Hypertext
.TITLE Non linear text
Normal 'text', or literature, takes the form of linear text in, for
instance, a book. Hypertext applies the technology provided by modern
computers to the presentation of information in a non-linear fashion.
When you are reading a reference book or a tutorial book, you have
to read all the material, or skip through trying to spot material
of relevance to you. When you find the information you were looking
for, you often come across concepts or terminology which you have to
look up in a separate chapter or book. To do this you use the contents
list or an index, to follow cross references if they are present.
With hypertext, the information is shown in manageable chunks, each
covering a few concepts, and each linked to related concepts. Also
the level of detail shown assumes a knowledgable user, but supports
lower levels of knowledge with additional material as and when
required, rather than assuming the lowest level and providing full
details regardless. Hypertext provides this automatic adaptability
to the user through highlighted words or phrases for which the user
may need further explanation.
These cross references can be followed without you worrying about
'losing your place' due to lack of fingers, pencils and slips of
paper to mark pages on the way to following up a reference. A list
is maintained of the frames of information you have read and you
can step backwards one frame at a time, or directly to one of these.
The index of a book is replaced by a powerful search capability
which is quite happy to tell you where every occurrence of 'the'
is in the document.
Hypertext may also display pictures for you to look at and on which
to select zones to get more information. It generally provides a
mouse driven interface where you can select the references to
follow by just pointing at them and clicking the mouse button.
.
.FRAME Advantages
.TITLE Why use hypertext
Hypertext offers a number of advantages over other methods of
storing and presenting information. Reading a hypertext document
does not require special skills, as the reader just has to select
references as required. This selection can be performed in a
number of intuitive ways.
Databases and Freetext Retrieval systems require specialist
knowledge of how to formulate a query.
Associations in hypertext are usually 'hard wired' so false
inter-relationships of data do not arise.
Of course hypertext, just like conventional literature, may require
that the user knows about the subject matter of the document to a
certain extent. Hypertext does, however, allow the material to be
structured so that an expert is not inundated with superfluous
information, whilst a beginner can obtain all the details needed.
.
.FRAME HyperShell
.TITLE The friendly hypertext system
HyperShell is a general purpose ~Fhypertext~E control system,
providing a text frame based presentation style with highlighted
references permitting navigation to other frames in the same or
another file, to graphic screens with selection zones on CGA, EGA,
VGA and Hercules systems, to popup notes which can themselves have
further references, and allowing backtracking through visited
frames, and collection and annotation of references. Also inline
~Fexpansion references~E in support of the main text are possible.
In addition to the more usual hypertext facilities, HyperShell
provides popup menus, menu bar operation, paged displays of menus
or text files, DOS management facilities, scripting language with
programming capability, variables, formfill input fields, program
invocation and support for compressed input files.
A comprehensive set of authoring and runtime support programs
are provided to extend the useability and power of this system.
.
.FRAME Hypertext for everyone
.TITLE Advantages of HyperShell
HyperShell is an attempt to make hypertext available at minimal
cost to the general PC user. By providing menu systems, DOS
control and a comprehensive set of building blocks, HyperShell can
be used for many more application areas than previous systems.
HyperShell also provides an extension to the Hypertext concept by
removing the requirement to always use a specially formatted text
file. By loading a HyperShell reference file on a particular
subject, for instance MSDOS commands, you can then browse through
ANY text file containing the odd reference to MSDOS commands. When
a command is within the section of text displayed on the screen,
that command is highlighted as a frame reference, and can be
selected to display a frame giving details of that command, and
permitting full reference selection to take place, before returning
to browsing through the text file.
.
.FRAME Market
.TITLE Who is HyperShell for
HyperShell is more than a simple hypertext system and is suitable
for a wide range of general purpose applications. It is therefore
not intended for a specific market and indeed has a very wide
range of users and ~Fuses~E. Most PC users could find a use for it,
either with existing material or for new applications.
The current users of HyperShell include the following:-
University and College Lecturers. School teachers. Students.
Management training consultants. Academic administrative and
library staff. Ecclesiastical administration. Accountants.
Hospital administration. Doctors, Pharmacists and Technicians.
Technical authors. Mediaware authors. Anthropologists.
Computer consultants. Computer analysts and programmers.
Shareware distributors. Electronic engineers. Architects.
Disaster planning consultants. Entymologists. Etymologists.
Museum technicians. Government Departments. Coin collectors.
Genealogists. Ornithologists. Musicians. Poets. Banks.
.
.FRAME Uses
.TITLE What can you use it for
HyperShell can be used for numerous applications including:-
- Help system with contextual entry and expertise levels
- Reference guide with problem diagnostic capabilities
- Menuing and help system for control of application programs
- Computer aided instruction (CAI) with response analysis
- Computer driven tests, exams etc. with multi choice and timing
- Text file browser with automatic cross reference to glossary
- Object oriented DOS directory browser and manager
- Information system, front desk support system
- Simple database with formfill, lookup, formatted display
- Slide show presenter with mouse selection for further information
- Program design specification support / Requirements analysis
- Program documentation coupled to source code browser
- Free format text database with cross references and associations
- Multi-dimensional 'outliner' for designing complex systems
- Disk based catalogue/pricelist with easy updating
- Interactive literature for participative fiction
.
.FRAME Equipment
.TITLE What you need to run it
HyperShell is designed to run on the widest range of equipment,
and the components do not need any more than a minimal 256k
single floppy mono system, although they will benefit from the
use of colour, a mouse, and a hard disk. You need at least a
twin floppy system to develop hyperfiles yourself.
Microsoft compatible mice are directly supported. Others
can be used in emulation mode if they are mapped to the
cursor keys, and the buttons to the RETURN and ESCAPE keys
HyperShell runs on MSDOS 3.0 and above, Concurrent DOS, OS/2,
DRDOS, and compatible systems such as the Archimedes PC emulator.
It can be run under Desqview if the -d command line flag is used,
and sufficient space is given to allow commands to run alongside
it (180k upwards). It should also run under Microsoft Windows 3.
.
.FRAME HyperShell as a menu
.TITLE More than just a text display
As well as providing a basic Hypertext system, HyperShell provides
the kind of facilities you expect to find in a 'Menu' system. You
can have many levels of menu, implemented as frames or popup menus,
and there is a way of having a menu reenter at the same point if
you want HyperShell to leave the whole memory for running a program
You can also include you own help system within a menu - something
which the other menu systems cannot do. You can also kick off a DOS
'shell' to execute a few commands from the command line, and
return to the same position in HyperShell. It is also possible to
use password entry before running a program.
The hypershell reader program can also swap itself to disk when it
runs another program, occupying just 1500 bytes until it is loaded
again. This retains the full context allowing the user to continue
where they left off.
.
.FRAME Look and feel
.TITLE Design your own system
The fact that HyperShell does not impose a fixed screen format on
you is of great benefit to those using HyperShell as the front-end
to their own systems.
As HyperShell provides input fields, popup menus and windows, you
can in fact use HyperShell to 'prototype' the appearance of a
system, which can be of benefit to those developing applications
software, as it allows them to try out various layouts and styles
before doing the labour intensive work of writing the software.
In fact, some users of HyperShell have not bothered with the last
step, as they have found the system capable of meeting their needs
as it stands.
The next frame shows how you can utilise another program's appearance.
.
.FRAME Captured screen
.TITLE )Example of captured text
~TK~BW ~TRF~TKile ~TRE~TKdit ~TRR~TKun ~TRC~TKompile ~TRP~TKroject ~Tw~BKOptions~TK~BW ~TRD~TKebug ~TRB~TKreak/watch
~TW~BB╒════════════════════════════════════~Tw Edit~TK~BW┌──────────────────┐~TW~BB═════════════════╕
│ Line 1 Col 1 Insert Indent Ta~TK~BW│~Tw~BK Compiler ~TK~BW│~TW~BBHELLO.C │
│~Ty/* HELLO.C -- Hello, world */ ~TK~BW│ ┌───────────────────────────┐~Ty~BB ~TW│
│~Ty ~TK~BW│ │ ~TRM~TKodel Small │~Ty~BB ~TW│
│~Ty#include <stdio.h> ~TK~BW│ │ ~TRD~TKefines │~Ty~BB ~TW│
│~Ty ~TK~BW│ │~Tw~BK Code generation ~TK~BW│~Ty~BB ~TW│
│~Tymain() ~TK~BW┌──────────────────────────────────────┐~TW~BB│
│~Ty{ ~TK~BW│ ~TRC~TKalling convention C │~TW~BB│
│~Ty printf("Hello, world\n"); ~TK~BW│ ~TRI~TKnstruction set 8088/8086 │~TW~BB│
│~Ty} ~TK~BW│ ~TRF~TKloating point Emulation │~TW~BB│
│~Ty ~TK~BW│ ~TRD~TKefault char type Signed │~TW~BB│
│~Ty~A~PnExample~E~Q ~TK~BW│ ~TRA~TKlignment Byte │~TW~BB│
│~Ty~A~PF+~K ~E ~TK~BW│ ~TRG~TKenerate underbars On │~TW~BB│
│~Ty ~TK~BW│~Tw~BK Merge duplicate strings On ~TK~BW│~TW~BB│
│~Ty ~TK~BW│ ~TRS~TKtandard stack frame On │~TW~BB│
│~Ty ~TK~BW│ ~TRT~TKest stack overflow Off │~TW~BB│
│~Ty ~TK~BW│ ~TRL~TKine numbers Off │~TW~BB│
│~Ty ~TK~BW│ ~TRO~TKBJ debug information On │~TW~BB│
│~Ty ~TK~BW└──────────────────────────────────────┘~TW~BB│
│~Ty ~TW│
├────────────────────────────────── Message ───────────────────────────────────┤
│~Tw Press space to continue ~TW│
└──────────────────────────────────────────────────────────────────────────────┘
~TK~BW ~TRF1~TK-Help ~TRF5~TK-Zoom ~TRF6~TK-Switch ~TRF7~TK-Trace ~TRF8~TK-Step ~TRF9~TK-Make ~TRF10~TK-Quit ~Tw~BB NUM ~TK~BW
.
.NOTE Example
This is an example of a text
screen captured with HCAP and
then converted to a frame using
the HI edit mode. It shows that
you can easily capture the
presentation style of other
programs. Press the space bar
to continue.
.
.FRAME The hyperfile
.TITLE HyperShell media files
HyperShell reference files (known as hyperfiles) have a notation
which can be readily understood, whilst providing a degree of
conciseness in the more powerful areas that is far preferable to
the excessive verbosity of some of the scripting languages used by
other hypertext systems. Extensive parsing has been avoided for
performance and space reasons, and because it does not provide as
much as it costs.
HyperShell provides a script language preprocessor so that verbose
specifications can be translated to the standard HyperShell syntax.
This allows a full language style to be used, without affecting the
speed or size of the HyperShell reader program, and also allows the
compact runtime hyperfile structure to be maintained.
.
.FRAME Hyperbooks
.TITLE A new publishing method
Using a special compression format, it is possible for authors to
write hyperfiles up to around 5 or 6 hundred frames, which can be
compressed and fitted onto a 360k floppy disk along with the
HyperShell reader program.
It is thus possible to publish your own material. This form of
publishing is a very cheap way of producing high quality material
which also benefits from the hypertext capabilities. Catalogues
and price lists can be easily kept up to date in this form.
Reference material is an ideal application for hypertext. A well
designed reference text can lead the reader to the information
they require very quickly.
Interactive literature is another application for hypertext, and
can take the form of 'adventure' systems or other kinds of fiction.
.
.FRAME Design aims
.TITLE What it should provide
HyperShell has been designed with the following goals in mind:-
* Fast startup and high performance navigation.
* File size not limited by available memory.
* Minimal memory usage when used as a menuing system.
* Text format material for ease of production and maintenance.
* Full hypertext functionality extended to support real applications.
* Extensive configurability for presentation style and interaction.
* Incremental learning - no steep 'first step' to producing material.
* Comprehensive set of authoring and support programs.
.
.FRAME Components
.TITLE What you get with HyperShell
Components provided include the following-
1. Various versions of the text mode HyperShell reader
2. The graphic version of the HyperShell reader
3. Integrated Development Environment, plus a graphic version
4. Extensive preprocessor and syntax checking program
5. Formatted hyperfile printout utility with glossary and index
6. General text editor, and a special note file editor
7. Conversion program for Norton Guide(tm) format files
8. Resident PCX or BLOAD graphic and text screen capture programs
9. Graphic preparation facilities for clips and full screen images
10. Graphics conversion, Paint program, Resource editor
11. Compression and expansion components and librarian
12. Resident popup subset of HyperShell for help applications
13. Resident floating point calculator and unit convertor
14. Example hyperfiles
15. Additional preparation programs and runtime support programs
.
.FRAME Documentation
.TITLE documentation files provided
Resources provided include:-
1. A number of icons in ICO format
2. A small selection of clip art and images in PCX format
3. over 50 fonts of assorted sizes in UDG format
4. Some simple sounds in HSN format
5. A number of mouse pointers in HMC format
6. Some palette files in PAL format
Documentation includes:-
1. Extensive users (authors) guide to HyperShell specification.
2. A utilities guide to the range of programs provided with HyperShell.
3. A hypertext document containing a full reference guide.
4. A Quick reference guide on disk and in printed format.
.
.FRAME Integrated Environment
.TITLE The interactive development environment
HyperShell includes a configurable editing environment, which can be
used for creating and maintaining hyperfiles. It can also be set up
for use as a free text storage database and other similar applications.
The integrated environment offers the full reader functionality,
so you can browse around a hyperfile and edit it immediately, with
the option of 'backing out' changes you have made.
Optional 'in-memory' editing makes editing easy and fast, whilst the
capability of working 'from disk' for larger hyperfiles is retained.
.
.FRAME Hyperfile checker
.TITLE Syntax and referential integrity checks
The Hyperfile checker provides a preprocessor for translating
the verbose HSL (HyperShell source language) into standard
HyperShell runtime specification language.
The HyperShell Checker program also performs a number of
checks against a hyperfile. It does checks for cross
references, duplicates, action codes in action references,
scripts and menus, dynamic menu codes, formatting codes,
sizing checks and section ordering. It can also provide:-
1. Summary totals of frames, items, and errors.
2. Cross-reference file showing inter-relationships.
3. Automatically generated frames and items to match references
4. Embedded error messages for use in the editor
.
.FRAME Hyperfile printer
.TITLE HyperShell formatted print utility
The HyperShell Printer program allows your hypertext documents
to be formatted and printed. This component provides:-
1. A listing of the text with optional highlighting using either
the built-in Epson(tm) or IBM(tm) compatible escape sequences,
Hewlett Packard LaserJet/DeskJet escape sequences,
or escape sequences set up using the configuration file.
2. Optional page breaks and index.
3. Optional full list showing all items, or notes as glossary.
4. Serial numbering of frames and items
5. Optional detailed list of references used in each item.
6. Support of special .PRINT directives allowing full control
of printing, headings, page throws, section numbering, etc.
7. Single frame print for use from reader component.
8. Optional output in Word Processor form (no line breaks).
.
.FRAME Note editor
.TITLE For editing small text files
The note editor provides a convenient means of editing small
text files (less than 400 lines), for use as notes, menus or
scripts.
It can also be used in support of a hyperfile as a means of
creating adhoc annotation text files related to a frame.
The editor has an easy set of editing commands, using either
control keys or a popup menu bar for entering the commands.
It also has a popup help screen showing the key mappings.
It provides block editing operations, word wrap and paragraph
formatting, which can be performed automatically.
The editor screen position, colours and style are set up
using the command line parameters, so it can be blended with
the frame display.
.
.FRAME Graphics capture
.TITLE Graphics capture and preparation
The screen capture and preparation system provides the tools
necessary to capture text and graphic screens from other
program displays, and prepare them for use within HyperShell.
The components provided are:-
1. TSR (Resident) screen capture program for text screens and CGA
and EGA graphic screens.
2. Preparation facility to allow selection zones to be defined
interactively, and actions mapped to the selections in a menu
for inclusion in a hyperfile.
Graphic screens can be compressed using the ~FFile compression~E
component, and substantial reductions in size are possible.
See Also the HyperShell Version 5 ~FGraphics preparation~E tools
.
.FRAME File compression
.TITLE For reducing the size of files
The HyperShell reader program, the integrated environment, the print
program and the checking program can determine if any input file is
compressed and handle the file access accordingly.
The compressed file maintenance program handles the compression and
expansion of text files, including hyperfiles, and screen image files:-
1. When compressing a file it can optionally change the
compression so that the file cannot be accessed as other
than a main hyperfile - to stop it being changed or used for
other purposes.
2. It can expand a file to its previous form, or display it
on the screen a page at a time.
.
.FRAME Popup subset
.TITLE For help systems
The resident popup HyperShell subset, known as HyPop, provides
a context sensitive popup help system, which can be used for
a wide range of applications.
It is available at the touch of a Hot Key. It takes the word
you currently have the text cursor positioned over as a search
string, and tries to find a frame about this word. Otherwise
it displays the index frame for you to navigate to the frame.
This program can be used for a wide range of help system
applications. The file format is a subset of HyperShell, and
so the files may be prepared using the integrated environment
and may be viewed using the standard HyperShell reader. The
files used by HyPop can be in compressed format.
The memory used by the program, and the 'HotKey' used to
call it up, may be specified in the file.
.
.FRAME Floating Point
.TITLE For mathematicians and engineers
The HyperShell Resident Extension, or HRX for short, is a means of
adding optional blocks of functionality to the basic HyperShell
programs, without compromising size or speed. The HRX is loaded into
the computers memory before running HyperShell.
The first one of these is supplied with version 4, and this
provides full floating point maths and unit and base conversions.
It also provides a set of variables for storage of intermediate
results.
This resident extension has a very fast 'seamless' interface
which makes it appear as though the facilities are built
into HyperShell.
.
.FRAME Version 5
.TITLE HyperShell Illustrated Edition
The graphic version of HyperShell brings a wealth of new material
to allow the production of a multitude of HyperMedia applications.
[1] ~FGraphic HyperShell~K1~E The graphic version of HyperShell
[2] ~FPaint Program~K2~E For the preparation of images
[3] ~FGraphics preparation~K3~E For capture and conversion of images
[4] ~FResource editor~K4~E For creation and editing of small bitmaps
Icons, Mouse cursors, Fonts, Patterns
[5] ~FPreparation support~K5~E Textual material preparation
[6] ~FRuntime support~K6~E Additional runtime programs
.
.FRAME Graphic HyperShell
.TITLE HyperShell with graphics
HyperShell Illustrated Edition is a graphic version of HyperShell
which supports full colour text in multiple fonts mixed with
graphics clips and graphic trim. Custom mouse cursors and palettes
are also supported. This is provided through the following:-
- Graphic clip sublanguage providing raster image clip display in
frames and notes, with image reference selection support. Also
adhoc clip capture, inversion and display. Supports library file
and high compression images for minimum memory usage. Mouse
cursor and palette loading.
- Graphics draw sublanguage providing pixel, pixel sequence and
line drawing with XOR capability for add/remove processing.
- Modes supported:- CGA mono (640x200), EGA colour (640x200)
EGA hires colour (640x350) and VGA hires colour (640x480).
There is also some partial VGA 256 colour and Hercules support.
.
.FRAME Paint Program
.TITLE HyperShell paint program
The paint program is a full featured paint package, providing a range
of standard painting tools as well as some specialist processing tools
for the production of graphic clips to be use in Graphics HyperShell.
- Freehand and straight line drawing, plus random and radial spray.
- Outline and filled boxes and ellipses, with special shadow effects.
- 11 scaleable Fonts with vertical or horizontal display. Text import.
- 36 fill patterns including 26 user definable patterns.
- Region processing commands including skew, invert, move, mirror,
convert colours, half colours, gradient fills, reduce, magnify
- Load full screen or clip from .PCX and Windows .BMP images
- Load graphic clips in .HGP, .BGF and .TIC formats
- Save clips in .HGP, .BGF, .TIC formats. Save full screen .PCX images
- Load, edit and save palettes in .PAL format
- Print to Laserjet (Dot Matrix not yet supported)
See the DEMO of version 5 for an illustrated tour of HPAINT.
.
.FRAME Graphics preparation
.TITLE Conversion of other graphic formats
Graphic capture - The HCAPPCX program is a TSR resident program which
may be used to capture .PCX images in the following
modes:- 640x200, 640x350, 640x480 (and 640x480mono)
Graphic convert - Conversion of GIF formats to PCX, for display in HG
and for use with the paint package. Can convert 256
colour images to 16 colours for use with HG.
Compression - A compression system offering a high ratio of
compression, for use with the graphic HyperShell
program.
Librarian - A program used for storing images and other
resources in a single library file, for use in the
graphics HyperShell program.
.
.FRAME Resource editor
.TITLE For the preparation of icons, fonts etc
The resource editor is a small bitmap editor permitting the
preparation of icons, mouse cursors and fonts for use in HG.
General editing commands include line and box drawing, cell
shifting and colour conversions.
Icons - Various sizes up to 40 by 32 pixels
- Load in .BGF, .TIC, .HGP, Windows .ICO
- Save in .HGP or .TIC format
- Can produce BGI .C structure for use in programs
Mouse cursors - Edit cursor and screen mask
- Load in .HMC format
- Save in .HMC format
- Can produce .C structure for use in programs
- Can test mouse cursor during editing
Fonts - Supports any depth by 8 bits wide
- Loads .UDG and many other font formats
- Saves .UDG for use in HG
- Powerful global processing commands
.
.FRAME Preparation support
.TITLE For the preparation of hyperfiles
The text file preparation utilities include the following.
Preparation program - This is for use in the initial stages of text
preparation to clean up and format text for use as a hyperfile.
It also provides statistics for a file, encrypts files etc etc.
Difference - This allows you to locate differences between versions
of textual material, optionally producing a changebar.
Spell checker - This checks the textual content of a hyperfile, and
can produce an errors file for use within the integrated
environment. It can also be used to extract pure text from a
hyperfile.
General Text Editor - This is for the preparation and maintenance
of text files. It can be used for hyperfiles up to 500k and
for configuration and other miscellaneous files.
.
.FRAME Runtime support
.TITLE Additional runtime components
HFIND - A background program for use with HyperShell. This can
find files on your hard disk, and can find text strings
in specified files. It can output in HyperShell paged
selection format, and also in HTYPE selection format.
HTYPE - A simple program to browse text files, with mouse control.
Lets you browse your directory structure and view files.
Supports simple hypertext links within files and across
files.
HFONT - A program to load .UDG fonts for use in text mode on
EGA and VGA adaptors. A number of fonts are provided.
.
.FRAME Resident Shell for HyperShell
.TITLE to popup HyperShell and its variants
HSRES is a resident shell occupying just 7k which permits HyperShell
to be popped up when you are in any non-graphic application.
It may be configured to pop up any of the versions of HyperShell,
and to pass certain information on the command line, it can utilise
hard disk or extra memory for swapping, and is now bundled in with
the HyperShell licence fee.
Also available is PGRES, which is a general resident shell for use
with certain programs other than HyperShell, allowing these to be
popped up when you are in any non-graphic application. This is
available at extra cost.
.
.FRAME HyperDex
.TITLE )Database extension
~Tr░░ ░░~TW ~Tb ~TW ~Tr░░░░░░░~TW ~Tr ~TW
A ~Ty░░ ░░~TW ~Tw ~TW ~Ty░░ ~TW ~Ty░░ ~TW
~Tg░░ ░░~TW ~Tb ~TW ~Tg░░ ~TW ~Tg░░ ~TW
N ~Tb░░ ░░~TW ~Tw ~TW ~Tb░░ ~TW ~Tb░░ ~TW
~Tm░░░░░░░░░~TW ~Tm░░~TW ~Tm░░~TW ~Tm░░░░░░ ░░░░░~TW ~Tm ░░░░░░~TW ~Tm░░ ~TW ~Tm░░~TW ~Tm░░░░░~TW ~Tm░░~TW ~Tm░░~TW
N ~TC░░░░░░░░░~TW ~TC░░~TW ~TC░░~TW ~TC░░~TW ~TC░░ ░ ~TW ~TC░~TW ~TC ░░~TW ~TC░░ ~TW ~TC░░~TW ~TC░~TW ~TC░~TW ~TC░░~TW ~TC░░~TW
~TR░░~TW ~TR░░~TW ~TR░░~TW ~TR░░~TW ~TR░░~TW ~TR░░ ░ ░~TW ~TR ░░~TW ~TR░░~TW ~TR░░~TW ~TR░~TW ~TR░~TW ~TR░░░~TW
O ~TG░░~TW ~TG░░~TW ~TG░░~TW ~TG░░~TW ~TG░░~TW ~TG░░ ░░░░░~TW ~TG░░~TW ~TG░░~TW ~TG░░~TW ~TG░░░░░~TW ~TG ░ ~TW
~TB░░~TW ~TB░░~TW ~TB░░~TW ~TB░░~TW ~TB░░~TW ~TB░░ ░ ░░ ░░~TW ~TB░░~TW ~TB░~TW ~TB░░~TW ~TB░░~TW
U ~TY░░~TW ~TY░░~TW ~TY░░░░░░░~TW ~TY░░░░░░ ░░░░░~TW ~TY░░~TW ~TY░░░░░░░~TW ~TY░░░░░~TW ~TY░░~TW ~TY░░~TW
~Tw┌────────┐~TW ~Tc░░~TW ~Tc░░~TW ~Tw┌──────────────────────────────────────────┐~TW
N ~Tw│ Full │~TW ~TC░░~TW ~TC░░~TW ~Tw│ ~TrHyperShell Database Extension option~Tw │~TW
~Tw│Database│~TW ~Tb░░~TW ~Tb░░~TW ~Tb░░~TW ~Tw│ ~TgA fully fledged database system ~Tw │~TW
C ~Tw└────────┘~TW ~Tg░░░░░░░~TW ~Tg░░~TW ~Tw└──────────────────────────────────────────┘~TW
~Tw ┌─────────────────────────────────────────────────────────────────┐~TW
I ~Tw┌─┴───────────────────────────────────────────────────────────────┐~TW ~Tw│~TW
~Tw│~TK ~BW HyperDex is an extended version of HyperShell, supporting the ~Tw~BK │~TW ~Tw│~TW
N ~Tw│ ~TK~BW database, index and memo file formats of dBase III and IV. ~Tw~BK │~TW ~Tw│~TW
~Tw│ ~TK~BW HyperDex is available for an additional 30 pounds personal ~Tw~BK │~TW ~Tw│~TW
G ~Tw│ ~TK~BW licence and an additional 90 pounds developer licence. With ~Tw~BK │~TW ~Tw│~TW
~Tw│ ~TK~BW Version 5, you can store graphics and sounds in the database. ~Tw~BK ├─┘ ~TW
~Tw└─────────────────────────────────────────────────────────────────┘ ~TW
~APress spacebar to continue~PF+~K ~E
.
.FRAME Concepts
.TITLE Features and capabilities of HyperShell
H Y P E R S H E L L C O N C E P T S
The terminology used in hypertext has not given us many standard
terms yet. HyperShell introduces a number of innovative ideas
for which terminology has had to be created.
This section gives an introduction to the terms and concepts used
in HyperShell, and describes how these are used.
~FHyperfile~E ~FReferences~E ~FExpansion references~E ~FPaged displays~E
~FFrame~E ~FNote~E ~FMenu~E ~FScript~E ~FActions~E
~FNavigation~E ~FBacktrack~E ~FControl menu~E ~FNotepad~E
Select one of these, or press the spacebar to work through them.
Press F3 to return here afterwards.
.
.FRAME hyperfile
.TITLE HyperShell control file
HyperShell uses data (or 'media') files called ~Fhyperfile~Es.
A hyperfile is a simple text file, and can be edited with a
word processor or a text editor, and viewed using text file
viewing programs, such as TYPE.
The process of creating a hyperfile is known as 'authoring'.
As a hyperfile is the equivalent of a book, the creator of
a hyperfile is its 'author'.
The material produced is subject to copyright laws, and usually
has a copyright statement indicating the author and date.
.
.FRAME frame
.TITLE unit of display
A frame is a unit of textual information containing references,
which is displayed during the normal operation of HyperShell.
What you are reading now is a frame called 'frame'.
Frames generally fit on one screen, but it is possible that
they could be split onto two or more screensfull, in which
case you can use the PgDn, PgUp and Home keys to move around
them.
A list of frames in a ~Fhyperfile~E is given in a ~Fcontents~E listing.
.
.FRAME Mouse
.TITLE Using a mouse
If you have a mouse compatible with HyperShell installed on
your system, with a mouse driver installed, HyperShell will
use the mouse driver directly. If you don't want to use the
mouse driver, specify the -m command line switch when running
HyperShell:-
hs -m hs
The block cursor should respond when you push your mouse about.
If it is not compatible, or if you do not have the driver
installed, it will have no effect. In this case, see the ~Fkeyboard~E
instructions for details of keyboard control of HyperShell.
.
.FRAME left
.TITLE left mouse button
The left mouse button, and the RETURN key, both have the
same action. This is generally to select an item over
which the ~Fmouse~E cursor is positioned.
When viewing a text file, requested by the ~FTYPE FILE~E
option from the ~Fcontrol menu~E, this selection returns to
the frame display, on a temporary basis.
.
.FRAME right
.TITLE right mouse button
The right ~Fmouse~E button has two main uses:-
To request the ~Fcontrol menu~E to control HyperShell,
when viewing a text frame. This facility is not
available at other times.
To cancel an operation which is in progress and
awaiting some input.
.
.FRAME middle
.TITLE the Insert button
If you have a 3 button mouse like the Genius mouse, the
middle key might be able to be used as an INSert key.
This can be used for:-
[1] ~NSelecting references~PNINS~K1~E - for the notepad
[2] ~FPicking words~PFText input~K2~E - on text input
.
.FRAME Keyboard
.TITLE Using the keyboard
The keyboard may be used in ~FHyperShell~E in a number of ways.
The ~Fcursor keys~E and others can be used when viewing ~Fpaged displays~E.
The ~FFunction keys~E can generally be used for control functions,
and the unshifted function keys are mapped to the actions provided
on the ~Fcontrol menu~E.
The RETURN and ESCAPE key have the same purpose as the ~Fleft~E
and the ~Fright~E mouse buttons.
The remaining keys can be mapped for control purposes or
selection of ~Freferences~E.
Also see ~FText Input~E for details of entering strings.
.
.FRAME Function Keys
.TITLE Direct control actions
The function keys, when used without the shift keys,
are mapped to the control menu actions. Pressing ESCAPE,
or the right mouse button, will bring up the ~Fcontrol menu~E
to show the available control actions.
Certain ~Fhyperfile~Es may map the ESCape key and right mouse
button to another form of control, such as a menubar, or
disable them altogether.
.
.FRAME Cursor Keys
.TITLE Selection cursor movement
The cursor keys are used to move the mouse cursor, which
may be positioned to enable selection for a ~Freference~PFreferences~E, or
a choice on a ~Fmenu~E.
.
.FRAME Text input
.TITLE String input and the copy cursor
When input is requested on the bottom line of the display and
when an input field is being used, the keyboard is used as usual
for inputting text. The RETURN key should be pressed to terminate
input, and the cursor keys may be used to position the cursor
within the text string to insert or delete characters.
It is also possible to copy a word or number from the screen when
in this mode by first pressing the PgUp key. Then by positioning
the mouse cursor over the word to be copied, pressing the INSERT
key will insert the word into the text. Also any text can be copied a
character at a time using the HOME key. This will copy a character
and move the cursor along one position, so the key can be held down
to auto-repeat when copying a string, or alternating INSERTs and
HOMEs can be used to copy a sequence of words. This mode can be
exited by pressing the PgDn or any normal key.
.
.FRAME Paged displays
.TITLE multi page selection lists
Paged displays are used to display various lists that may
occupy more than one screenful. Certain keys are available
during a paged display.
The PgDn and the HOME keys are always available, and allow
you to page through the list or return to the start.
The PgUp and END keys may also be available, and allow you
to move backwards through the list, or move to the end.
.
.FRAME Navigation
.TITLE How to browse a HyperShell document
This section describes how to use ~FHyperShell~E.
~A~PZX74;ZY6~E~Q
If you have a mouse, you can use it to move the mouse cursor ->
around the screen to certain highlighted words or phrases called
references, and press the left button to select the reference.
Select ~FMouse~E for a full description of mouse usage.
If you don't have a mouse, you can always use the keyboard.
The cursor keys move the mouse cursor around. Press Tab
for the next highlit field and Shift/Tab for the previous one.
Press the RETURN key to select a field, or ESCAPE to cancel.
Select ~FKeyboard~E for a full description of keyboard usage.
If you want to exit to DOS at any point, just press F10.
.
.REMARK
Features of HyperShell
.
.FRAME References
.TITLE Types of reference in text
~i2
[f] A ~FFrame~PnFrame~Kf~E reference allows you to move to a new frame
[n] A ~nNote~Kn~E reference pops up a small textual note for you
[m] A ~MMenu~PnMenu~Km~E reference pops up a menu for you to choose from
[s] A ~SScript~PnScript~Ks~E reference does a sequence of actions
[a] An ~AAction~PnAction~Ka~E does an unspecified action of some sort
~i6
The above references in this frame all pop up notes describing
their normal function. Press the key in [brackets] to select one.
As you can see, keys can also be mapped to references.
~i2
[e] An ~AExpansion Reference~PZL1~Ke~E provides additional information 'inline'.
~h1 ~FExpansion references~E provide additional material which becomes
~h1 visible when they are selected, and may be removed by reselecting.
.
.NOTE Frame
A frame reference allows you to
move to another frame of text.
To get back from that frame, you
can use the backtrack facility.
~FMore on Frame references~PFFrame Reference~E
.
.NOTE Note
A note pops up a small window
containing some information
about the word highlighted.
You are reading a note now.
~FMore on Notes~PFNote~E
.
.NOTE Menu
A menu pops up a list of items
for you to select from. You can
cancel the selection by clicking
the mouse outside the menu or
by pressing the right mouse button
~FMore on Menus~PFMenu~E
.
.NOTE Script
A script performs a sequence of
actions. This may do something like
displaying a series of notes, or
prompting for a number of parameters
for a command to be issued to DOS.
~FMore on Scripts~PFScript~E
.
.NOTE Action
An action is almost anything,
including Notes, Menus,
Backtracking, Prompting, issuing
DOS commands or even Quitting.
~FMore on Actions~PFAction Reference~E
.
.FRAME Frame reference
.TITLE go to a frame
When a frame reference is selected, the ~Fframe~E selected is
displayed on the screen, replacing the one currently on display.
Frames, or other references may be selected from this frame to
further follow up the reference.
When the necessary information has been found, it is possible
to ~Fbacktrack~E to any of the previous frames you have seen, either
one step at a time or by selecting from the ~Alist of frames~PFbacktrack list~E you
have seen.
Certain frame reference selections do not get added to
the ~Fbacktrack~E information.
.
.FRAME Expansion references
.TITLE Changing what you see in a frame
When users of differing expertise read a hyperfile, they do
not necessarily want to read the full detail about a topic.
It is possible to have varying degrees of detail 'hidden'
from display until a request is made for that detail. In
hypertext jargon, this is known as an expansion reference.
To show how this works, select the following reference.
[d] ~ADetail~PZL1~Kd~E
~h1~DNWhen you first read this frame, this paragraph was not shown.
~h1Selecting the 'Detail' reference caused this text to be displayed.
~h1If you now select the 'Detail' reference again, it will disappear.~DT
~h1
When you return to the frame, the level of detail displayed will
remain as you left it. It is also possible to influence the degree
of detail shown throughout a hyperfile in a similar fashion.
.
.FRAME Note
.TITLE display a note
A note is a pop-up display of information. This appears in a
box which is smaller than the overall size of the screen.
The note may have highlighted ~Freferences~E or input fields in it,
and this can be selected as for those in the main ~Fframe~E text.
The note is cleared when a reference is selected from it, or
when a ~Fmouse~E button or ~Fkey~PFkeyboard~E is pressed.
When the note is finished with, it 'pops down', redisplaying
the part of the screen it had overlayed.
.
.FRAME Menu
.TITLE popup a menu
A pop-up menu is a list of options displayed so that a choice
can be made from them. Menu options can result in any kind of
~Faction~PFactions~E, unless the menu is used to provide the parameter for
an action, in which case all options have the same effect.
An option is chosen by clicking the ~Fleft~E mouse button, or pressing
the ENTER key, when the required option is highlighted. Function
keys may be mapped to the menu options, in which case the keys are
shown as 'F1', 'F2' etc. alongside the options. An option may be
selected by pressing the corresponding key. If function keys are
not mapped, the initial letter of the option may be pressed to
select the option.
The menu can be cancelled by pressing the ~Fright~E mouse button, or
pressing the ESCAPE key.
Certain menus contain ~FMenu symbols~E which show the kind of actions
which will be performed when the options are selected.
.
.FRAME Menu symbols
.TITLE Guide to menu actions
Some menus contain symbols to act as a guide to what the menu
actions are. These symbols are as follows:-
ƒ Frame Note
≡ Menu ≈ Script
« Backtrack Ω Quit
δ DOS command Σ Direct command
∞ Chained command Φ Change directory
# Set key mapping α Set/test variable
º Set option ° Refresh screen
τ Type file π Print/popup message
≤ Open/Read file ≥ Open/write file
? Do unspecified action ▒ Graphic display
¿ Extended/negative actn ¬ Next input field
⌡ Jump in script ⌠ Label/load variable
.
.FRAME Script
.TITLE perform a script
A script is a sequence of ~Factions~E, possibly with some flow
control structures such as loops and selections.
Scripts are used for a number of purposes:-
- to display a sequence of ~Fnote~Es
- to set up a number of parameters for a program command line
- to set variables to modify the displayed information
- to act as a small 'program' to perform complex processing
.
.FRAME Action reference
.TITLE do some action
An action reference shows that some action is to take
place that is not one of the usual actions i.e. a ~FMenu~E,
a ~FNote~E, a ~FFrame~E or a ~FScript~E.
Selecting an action reference will have some effect other than
the usual actions, and the contextual information should give
you some clue as to what this may be.
.
.FRAME Backtrack
.TITLE retracing your steps
When you have followed up a ~Freference~PFreferences~E, you may wish to
retrace your steps back to the initial text you were reading.
The backtrack capability allows you to do this.
The ~Fcontrol menu~E has an option called BACKTRACK, which steps
you back one frame.
If you wish to go directly back without having to do it one
step at a time, the SELECT BACK option of the ~Fcontrol menu~E
will allow you to choose any frame on the ~Fbacktrack list~E.
.
.FRAME Backtrack list
.TITLE multiple backtrack
The ~Fcontrol menu~E provides an option to select the point in
the list of text frames you have visited to which you wish
to return, 'unwinding' the list of frames you have visited
since then in the process.
A full screen menu is presented, allowing you to select a
frame reference from the frames visited.
.
.FRAME Control menu
.TITLE general control menu for HyperShell
When you are viewing a text frame, you may request a
general menu for controlling HyperShell, by pressing
either the ~Fright~E mouse button or the ESCAPE key on
the ~Fkeyboard~E.
This menu presents a number of options.
.
.FRAME Control options
.TITLE choices on the control menu
The default control menu offers the following options:-
~nHOME~E (or ~nHELP~E) - Go to home frame (or give help)
~nCONTENTS~E - List contents of current file for selection
~nBACKTRACK~E - Backtrack one frame
~nSELECT BACK~E - List backtrack list for selection
~nNOTEPAD~E - List noted actions for selection
~nSEARCH~E - Search current file for text string
~nTYPE FILE~E - Type contents of text file
~nDO ACTION~E - Allow action to be directly requested
~nDOS SHELL~E - Provide DOS command subshell
~nEXIT TO DOS~E - Exit directly to DOS
.
.NOTE HOME
The HOME frame is the first ~Fframe~E in a ~Fhyperfile~E, and
generally provides some kind of lead-in to the browsing
of the hyperfile. It is useful to return to the home
frame if you appear to be lost. The ~Fcontents~E list and
the ~Fbacktrack~E list are also useful when this happens.
.
.NOTE HELP
The HELP menu is usually invoked by pressing the '?' key,
although some hyperfiles may map the first control menu
action (and the F1 key) to it.
The help menu is an application specific set of information
and will usually offer a number of note displays describing
the application provided by the hyperfile.
.
.NOTE CONTENTS
This command lists the contents of the current ~Fhyperfile~E.
The list is displayed a page at a time, and a selection
can be made from the highlighted ~Fframe~E names, using the
usual ~Freference~PFreferences~E selection mechanism.
.
.NOTE NOTEPAD
This option lists the ~Freferences~E added to the notepad
list, and permits them to be selected and followed.
During this paged display, the entries on display can
be removed from the notepad by pressing the Del key on
the keypad when the mouse cursor is positioned over the
item. All occurrences of the reference in the notepad
will be removed.
.
.NOTE SEARCH
This option prompts for a search string and then
searches the title and text of all frames in the
current hyperfile for occurrences of the string.
All occurrences are listed, followed by the frame name
of the frame containing the search string.
The search is not case sensitive, and the search
string may be entered in lower or uppercase.
.
.NOTE TYPE FILE
This asks for a file name and lists the file a page at a time.
Pressing the ~Fleft~E ~Fmouse~E button or the RETURN key returns to
the frame display, TYPE FILE will return to the file at the
current point.
The PgUp and PgDn keys may be used to move through the file, and
the HOME key and the END move to the start and end of the file.
The '/' or F6 key allows a search string to be entered, and a search
made. The F5 key searches for the next occurence of the search string.
The '#' key allows a page number to be entered to position the file.
The ~Fright~E ~Fmouse~E button or ESCAPE terminates the display.
.
.NOTE DO ACTION
This option permits an ~Faction~PFactions~E command to be entered
directly. An example action would be to perform a DOS
command such as DIR /W by entering the ~Faction~PFactions~E :-
DDIR /W
.
.NOTE DOS SHELL
This option permits a DOS shell to be executed to allow
commands to be entered at the command line.
When you wish to return to ~FHyperShell~E, enter the EXIT
command to the DOS command processor.
.
.NOTE EXIT TO DOS
This action exits immediately from ~FHyperShell~E.
No confirmation is sought before doing this, unless
configured into the hyperfile.
.
.FRAME Notepad
.TITLE List noted actions for selection
This option lists the ~Freferences~E added to the notepad
list, and permits them to be selected and followed.
During this paged display, the entries on display can
be removed from the notepad by pressing the Del key on
the keypad when the mouse cursor is positioned over the
item. All occurrences of the reference in the notepad
will be removed.
.
.FRAME Contents
.TITLE list contents of HyperFile
This command lists the contents of the current ~Fhyperfile~E.
The list is displayed a page at a time, and a selection
can be made from the highlighted ~Fframe~E names, using the
usual ~Freference~PFreferences~E selection mechanism.
.
.FRAME Type file
.TITLE list contents of text file
The contents of the specified file are listed. The listing is
presented a page at a time, and certain keys may be used for
movement up and down the file. Other keys are used for
control purposes. Pressing the ~Fleft~E ~Fmouse~E button or the
RETURN key returns to the frame display, where subsequent selection
of the TYPE FILE option returns to the file at the current point.
The PgUp and PgDn keys may be used to move through the file, and
the HOME key and the END move to the start and end of the file.
The '/' or F6 key allows a search string to be entered, and a search
made. The F5 key searches for the next occurence of the search string.
The '#' key allows a page number to be entered to position the file.
The ~Fright~E ~Fmouse~E button or ESCAPE terminates the display.
.
.FRAME Actions
.TITLE Commands for control of HyperShell
HyperShell actions are the commands used to cause various
this to take place. There are a large number of actions,
many of which can be further modified to influence the
resulting action. For example, actions perform the
following kinds of things:-
Display frames, notes, menus and text files.
Display Graphic screens to allow selection.
Run programs or batch files.
Run scripts, and control the flow of scripts.
Set configuration options, colours and key mappings.
.
.FRAME Effects
.TITLE Special presentation effects
HyperShell provides some facilities for special display
effects and control over the creation of subwindows for
special purposes. The box draw facility is used for the
double line frame in this hyperfile. It can also be used
for drawing adhoc boxes on the screen. A similar facility
allows a window, with an optional box surround, to be
defined for subsequent text output. Also it is possible
to enter delays in text, and to use a 'teletype mode'
which slowly displays the text. These facilities are
demonstrated by the following reference:-
[e] ~ABox explode and windows~PsExplode~Ke~E
.
.SCRIPT Explode
Vx=1
Vy=1
O*00;O*31
-- clear screen
i~X1~Y1~a~X79~Y24~b6
LEXP
Vj=80-x
Vk=25-y
i~X$x~Y$y~a~X$j~Y$k~DK~b1~DT
Vx=x+1
Vy=y+1
vy12;jeXOUT
JEXP
LXOUT
i~X$x~Y$y This is an example of what we can do with box drawings
i~X$x~d What else can we do with boxes - wait and see
Y&G200
LEXP2
Vj=80-x
Vk=25-y
i~DT~X$x~Y$y~a~X$j~Y$k~b7
Vx=x-1
Vy=y-1
vy0;jeDOWIN
JEXP2
LDOWIN
i~X1~Y1~a~X79~Y24~DD~b6
-- i~X1~Y1~a~X78~Y24~b6
Vx=1;Vy=1
LWINS
Vs&N$xKJMUVSWALP
Vj=x+10
Vk=y+4
-- i~X$x~Y$y~a~X$j~Y$k~D$s~b3~DT
i~X$x~Y$y~a~X$j~Y$k~D$s~b3
iHi there
iThis is
ia window
Zr
Vx=x+8
Vy=y+2
vy18;jgNEXT
JWINS
LNEXT
Y&G400
O*30;O*01
y
.